home *** CD-ROM | disk | FTP | other *** search
/ Kit PC World De Ampliacion De Windows 95 / Kit PC World de ampliacion de Windows 95.iso / clarion / cw15 / examp15.z / TREE.TXT < prev    next >
Text File  |  1995-09-07  |  6KB  |  140 lines
  1. The TREE Application
  2.  
  3. TREE is a simple application that illustrates the productivity,
  4. power, and performance available with Clarion for Windows V1.5:
  5.  
  6.  
  7. High Productivity
  8.  
  9. An application like TREE can easily be developed in 2 days or less
  10. with CW1.5. The data dictionary for TREE (Orders.dct) was created
  11. using the data dictionary editor, however, these file layouts
  12. could have been imported directly from existing data files.
  13.  
  14. The core of the application, which consists of the MDI frame and
  15. menu structure along with the file browse and update dialogs, was
  16. automatically produced by the Application Wizard. The customer
  17. order tree dialog was produced by the RelationTree template. The
  18. reports were all produced by the Report template.
  19.  
  20. Fewer than 12 lines of embedded source code were needed to
  21. supplement the behavior generated by the standard templates. The
  22. test time required to validate TREE was minimal because nearly
  23. 100% of its source code was contributed by reusable pre-tested 
  24. templates.
  25.  
  26.  
  27. Relation Tree
  28.  
  29. TREE is named for the Customer/Order/Item expandable tree control
  30. invoked from the Browse menu. Each element of the tree displays
  31. the description of a customer, Order, or Item record. The
  32. different levels are distinguished by unique icons and display
  33. colors. In addition, each level can be associated with a different
  34. dialog box in order to insert, change, or delete records. These
  35. requests can be made using command buttons or by clicking the
  36. right mouse button. The only embedded source code (the code you
  37. write) necessary to produce this complex behavior creates an item
  38. description by looking up a record in the Product file.
  39.  
  40.  
  41. Automatic Primary Keys
  42.  
  43. Customer numbers, order numbers, and item numbers are automati-
  44. cally generated by the TREE application. Accordingly, they cannot
  45. be modified and never appear in an entry control. (They are
  46. displayed as strings.) This behavior is specified in the data
  47. dictionary is generated automatically by the templates.
  48.  
  49. The primary key for the customer file contains only the customer
  50. number. The primary key for the order file contains a customer
  51. number and an order number. Orders for each customer start with
  52. order number 1. Similarly, the primary key for the item file
  53. contains a customer number, order number, and (line) item number.
  54. Item numbers start with 1 for each order.
  55.  
  56.  
  57. Referential Integrity
  58.  
  59. If you try to delete a record for a customer with pending orders,
  60. you will be prevented from doing so. This is called a
  61. Delete/Restrict referential integrity constraint.  Likewise, if
  62. you delete an order, all of its items will also be deleted.  This
  63. is called a Delete/Cascade restraint.  Nor can a product be
  64. deleted if it has pending items (Delete/Restrict). There is no
  65. need for Update constraints because the relevant primary keys
  66. cannot be changed.
  67.  
  68. The behavior that produces these referential integrity constraints
  69. is automatically produced by the templates as a result of data 
  70. dictionary settings.  At any time in the future, RI behavior can 
  71. be changed by simply modifying the data dictionary and regenerat-
  72. ing the application.
  73.  
  74.  
  75. Database Portability
  76.  
  77. TREE uses the TopSpeed database engine, a proprietary technology
  78. that uses minimal resources (50K DLL or library) and produces a 
  79. very small footprint (by dynamically compressing data). The 
  80. TopSpeed engine is also surprisingly fast. However, this 
  81. application can be retargeted to use Clarion, dBase, FoxPro, 
  82. Clipper, Btrieve, ODBC, Oracle, or AS/400 files by simply 
  83. changing data dictionary settings and regenerating. (Oracle and 
  84. AS/400 drivers are available at additional cost. SQL Server
  85. and Sybase drivers will be available soon.)
  86.  
  87.  
  88. Multi-threaded MDI 
  89.  
  90. TREE uses a multi-threaded, multi-document interface (MDI). Each 
  91. browse window and report starts on a different thread.  As a 
  92. result, all three browse windows can be open while reports are 
  93. printing. CW1.5 uses its own internal thread management under 
  94. Windows 3.1x. 32 bit applications use standard Windows 95 or 
  95. Windows NT threads.
  96.  
  97.  
  98. Integrated Print Engine
  99.  
  100. TREE prints 3 reports: a customer invoice, a mailing list, and a 
  101. price list. The invoice and price list use color graphics.  The 
  102. invoice report contains embedded source that calls a browse dialog
  103. to identify the invoice requested. The Report template automati-
  104. cally produces the necessary behavior to preview reports before
  105. they are printed.
  106.  
  107. Importantly, these reports are contained within the application 
  108. itself--an external report writer is not required.  Like TREE, 
  109. many "real world" applications can benefit from the high degree 
  110. of interaction and programmability offered by an integrated print
  111. engine. Such integration offers design time, run-time, and life-
  112. time efficiencies because all visual elements (windows and 
  113. reports) use the same development environment, data dictionary, 
  114. and database drivers.
  115.  
  116.  
  117. 16/32 Bit Word Length
  118.  
  119. Under the control of a setting in the project system, CW1.5 will
  120. produce either 16 bit or 32 bit versions of TREE. All CW 
  121. applications are word-size neutral unless they specifically call
  122. Windows functions that are not supported by all versions. The 
  123. Windows 95 controls such as property sheets (tabbed notebooks) and
  124. tool tips (help balloons) have been cloned for use with Windows 
  125. 3.1x. In the same vein, 16 bit VBX support has been cloned for use
  126. with Windows 95 and Windows NT.
  127.  
  128.  
  129. One-Piece Executable
  130.  
  131. TREE complies into a 780K one piece 16 bit or a 723K 32 bit
  132. executable. This single executable comprises the entire "ship 
  133. list" for the TREE application. If you are shipping more than one 
  134. CW application, you should consider shipping the CW library as a  
  135. stand-alone DLL.  When linked with the stand-alone run-time 
  136. library, the TREE executable takes only 224K (243K for 32 bit). 
  137. The "ship list" includes CWRUNxx.DLL (the run-time library) at 
  138. 644K (512K for 32 bit) and CWTSPxx.DLL (the TopSpeed database 
  139. driver) at 50K (42K for 32 bit).
  140.